package cn.iocoder.yudao.module.water.service.year;

import java.util.*;
import javax.validation.*;
import cn.iocoder.yudao.module.water.controller.admin.year.vo.*;
import cn.iocoder.yudao.module.water.dal.dataobject.year.ReportYearDO;
import cn.iocoder.yudao.framework.common.pojo.PageResult;
import com.baomidou.dynamic.datasource.annotation.DS;

/**
 * 年报 Service 接口
 *
 * @author 左达成
 */
public interface ReportYearService {

    /**
     * 创建年报
     *
     * @param createReqVO 创建信息
     * @return 编号
     */
    Long createReportYear(@Valid ReportYearCreateReqVO createReqVO);

    /**
     * 更新年报
     *
     * @param updateReqVO 更新信息
     */
    void updateReportYear(@Valid ReportYearUpdateReqVO updateReqVO);

    /**
     * 删除年报
     *
     * @param id 编号
     */
    void deleteReportYear(Long id);

    /**
     * 获得年报
     *
     * @param id 编号
     * @return 年报
     */
    ReportYearDO getReportYear(Long id);

    /**
     * 获得年报列表
     *
     * @param ids 编号
     * @return 年报列表
     */
    List<ReportYearDO> getReportYearList(Collection<Long> ids);

    /**
     * 获得年报分页
     *
     * @param pageReqVO 分页查询
     * @return 年报分页
     */
    PageResult<ReportYearDO> getReportYearPage(ReportYearPageReqVO pageReqVO);

    /**
     * 获得年报列表, 用于 Excel 导出
     *
     * @param exportReqVO 查询条件
     * @return 年报列表
     */
    List<ReportYearDO> getReportYearList(ReportYearExportReqVO exportReqVO);

    @DS("report")
    List<ReportYearDO> getReportOneYearList(String date);
}
